COMMENT ⊗   VALID 00007 PAGES
C REC  PAGE   DESCRIPTION
C00001 00001
C00002 00002	This file, DM.ME[UP,DOC], lists some facts and user procedures of interest
C00003 00003	Use of DM Hardware
C00005 00004	Use of DM Software
C00019 00005	Use of DMs via TIPs
C00024 00006	Use of DMs from TENEX hosts
C00025 00007	Use of DMs from ITS hosts
C00028 ENDMK
C⊗;
This file, DM.ME[UP,DOC], lists some facts and user procedures of interest
to people with Datamedia Elite 2500A display terminals (DMs).
Use of DM Hardware


When using terminal with 300 baud modem:

(1) Connect pins 2, 3, and 7 of the Datamedia LINE connector to pins 2, 3,
and 7, respectively, of the modem's TERMINAL connector.

(2) Switch the terminal's speed selector to 300, and dial in.

(3) To disconnect, hang up the phone.


When using terminal with internal 1200/150 modem:

(1) Connect stub cable coming out of back of terminal into the  terminal's
LINE connector.

(2) Plug white cable into jack at back of terminal.

(3) If your phone doesn't have a jack, remove the cover of the little  box
where the wire goes into the  wall and replace with the adapter  provided,
creating a phone jack.

(4) Plug other end of white cable into your phone jack.

(5) If the phone has a  plug, plug it into the  back of the plug you  just
inserted.

(6) Switch the terminal's speed selector to SEL.

(7) Push the small switch next to the speed selector to the left.

(8) Now dial SAIL or AMES-TIP (or whatever).  When the MODEM answers  with
a tone, switch the small switch to the right and hang up the phone.

(9) To disconnect, push the break key  on the terminal for a few  seconds,
and then push the small switch to the left and the line will be released.
Use of DM Software


[Note:  If you have trouble with  typeout at any time, especially if  tabs
in the typeout don't seem  to work, type [BREAK] P  (see below for how  to
type this), which will  clear and refresh  your screen, including  setting
your DM's tab stops.  If your DM doesn't have tab stops, type the  monitor
command TTY NO TABS  and then type  [BREAK] P.  If  you have trouble  with
your line editor, type [ESC] R.]

DM terminals are considered full display  terminals by the system, and  as
such they have  virtually all  the capabilities  possessed by  DD and  III
displays except (1) keyboard and screen mapping, (2) audio switch control,
and (3) vector displaying.  In  particular, the line editor, the  wholine,
and the full Stanford AI Lab character set with CONTROL and META bits  are
available on DMs, although a few  Stanford characters must be quoted  (see
below) in order to be input.

To have a list of DM keyboard commands printed on the XGP, type HELP DMKEY
to the monitor and follow instructions; this  can only be done on a DD  or
III display  since  it  causes  XGP  output  which  should  be  picked  up
immediately.

Since the  DM  keyboard  does  not  have keys  for  all  of  the  Stanford
characters, certain characters must be typed in their ASCII CTRL form; for
example, partial-sign (∂) is ↑O and  thus must be input as CTRL-O.   Also,
since  the  DM  display  does  not  have  symbols  for  all  the  Stanford
characters, those characters that must be typed in as CTRL-something  will
be displayed in  a special  form, namely  as either  BOLD-something or  as
BLINKING-something.   On  SU-AI   DMs,  CTRL-something   will  appear   as
BOLD-something; on other DMs  that have not  been modified to  interchange
the  BLINKING   and  BOLD   functions,  CTRL-something   will  appear   as
BLINKING-something.  For example, on SU-AI DMs partial-sign (∂ or ↑O) will
be displayed as BOLD-o; on non-modified DMs it will be BLINKING-o.  If you
have a non-modified DM and don't like blinking (you won't), then type  TTY
NO BOLD or use  the NOBOLD LOGIN  option.  The XGP  printout made by  HELP
DMKEY lists the  correspondences between  Stanford AI  Lab characters  and
their ASCII CTRL representation.

Here is a summary of what you have to type to get certain effects:

	To get [ESC], type [NUL].  Most DD-type ESC commands work on DMs.
	To get [BREAK], type [NUL] and then "-" (minus sign).
	To get (CONTROL)<char>, type (EDIT)<char>;
	       that is, hold down (EDIT) while typing <char>.
	To get (META)<char>, type (EDIT)[NUL] and then <char>.
	To get (META)(CONTROL)<char>, type (EDIT)[NUL] and then (EDIT)<char>.

	To undo [ESC] or [BREAK], type [DEL].
	To undo (META), type [NUL] and then [DEL].

	To get [CLEAR], type the bottom unlabelled key at keyboard left, or [MR].
	To get [FORM], type [↑L].
	To get [BS], type [DEL].
	To get [CALL] (that is, two ↑C's), type [CALL].
	To get deferred [CALL] (that is, one ↑C), type (EDIT)[CALL].

	To suspend typeout, type [HOLD]; to resume typeout, type [HOLD] again.

The three characters β≡∨  are hidden under the  keys [CALL], [CLEAR],  and
[HOLD], respectively.  To get one of the characters β≡∨, you must quote it
by preceding  it  with  [NUL].   However, if  you  want  (META)  with  the
character, then  the  quoting is  automatic  with the  add-(META)  command
(EDIT)[NUL].   Thus  you  cannot  type  (META)[CALL],  (META)[CLEAR],   or
(META)[HOLD] because you would get (META)β, (META)≡, or (META)∨ instead.

You must tell the system you are a DM by either typing the TTY DM  command
or logging in with DM among your LOGIN options (if you have a DM with  the
full Stanford character set,  use the TTY DM128  command and DM128  option
instead).  The system will erase the DM  screen and then set the DM's  tab
stops while typing an initialization message at the top of the screen.  If
you have a DM terminal that lacks  hardware tabs (all of the AI Lab's  DMs
have them), then you should type TTY NO TABS (or have the NOTABS  option);
in that mode  each tab to  be output  will be converted  to an  equivalent
number of spaces, which will of course usually take longer to output  than
just a tab.

When you log  out, your terminal  will "go available"  about five  seconds
later.  A beep is output to  tell you when this has happened--your  screen
will not be erased at that time.   You should not hang up the phone  until
you hear this beep; otherwise, someone else may call in right then and  be
able to see  what was  displayed on your  screen.  When  your terminal  is
"available", you cannot  type [ESC] or  (META) until you  have typed  some
other character to initialize the terminal.  Typing [ESC] or (META) to  an
uninitialized terminal will  cause the  echoing of  a beep  with no  other
result.

If you  do  not get  the  initialization message  when  you first  type  a
character after  dialing in,  then you  should immediately  do a  [BREAK]P
(i.e., the three  characters [NUL] -  P) to force  it.  This will  usually
show you the  display screen  of the previous  user who  probably hung  up
before the terminal "went available".  If you don't type [BREAK]P in  this
case, there is no guarantee of consistent output as your terminal may have
its cursor at some  place other than  where the system  thinks it is.   If
[BREAK]P doesn't get  you the  initialization message but  does erase  and
redraw the screen, then type the monitor command TTY TABS (unless your  DM
terminal doesn't have hardware tabs), followed by another [BREAK]P,  which
should get you the message at the top of the screen.  If typeout screws up
after correct  initialization,  then  either you  are  having  phone  line
trouble or there is  a bug in  the DM display  service--the former is  the
best guess.  If you  get perfectly repeatable  typeout screwups, then  you
may have found a display service bug  and you should report to ME  exactly
what you did to cause it.  You should also verify that it happens on  both
phone lines.  If it only happens on one phone line, then you should report
the phone line trouble to TED.


Notes:

The user job part of the wholine is now only updated when it has changed.

The don't-allow-beeps command [BREAK]B is not valid from DMs as they  have
no audio switch selection to preserve.  You can however turn your beeper's
volume up or down  on the back  of the keyboard.   Put your terminal  into
local mode by disabling  FULL DUPLEX and  type CTRL-G to  make it beep  to
adjust the volume.  Be sure to restore FULL DUPLEX when done.

Dpy programs (UPGIOT UUO) now run on DMs--see UUO.UPD[S,DOC], page 15.

While you are holding (even if HOLDING message does not appear), your line
editor will appear on the HOLDING message line (3rd line of screen).

Two new escape commands are now available to DM users for suppressing user
program display output  outside of  a specified  range of  columns on  the
display.  ESC m < (where m is decimal) suppresses all user display  output
to the left  of column  m, and  ESC n >  (n decimal)  suppresses all  user
display output to the right  of column m.  The  only type of output  these
commands affect is user  program output generated by  the UPGIOT UUO  (ie,
display program  output), and  even  then it  does  not affect  output  in
insert/delete mode nor does it affect output of CRs and LFs.

Note that ESC 5 < (for example) will suppress output to the left of column
5 and  therefore whatever  text already  appears in  columns 1  to 4  will
(normally) not be erased even when new text appears starting in column  5.
However, after an ESC 40 > (for example) old text in columns 41 to 80 will
usually be erased  by new  text at  or before  column 40  since output  of
actual text usually causes the rest of the line to be erased (except  when
this erase-to-end-of-line feature is  inhibited).  Also, if, for  example,
ESC 20 < and ESC 10 > are  given, all output is suppressed except for  CRs
and LFs and the line erases.

Thus these commands can be used to speed up displaying by E, WHO and other
display programs by suppressing unneeded output.

ESC < resets  the left DM  margin to zero  and ESC >  resets the right  DM
margin to infinity.  ESC N resets both margins, as does a RESET or  DPYCLR
UUO.  BRK > sets the right margin to 0, thus suppressing all text.
Use of DMs via TIPs


Full-fledged  DM  service  is  now  available  via  TIPs.   The  following
discussion refers  to  our particular  situation  with the  AMES-TIP,  but
except for the  existence of two  1200/150 baud ports  there, the  example
below should be enough to allow one to use other TIPs as well.

Some extra work is required to set up  the TIP to allow EDIT key bits  and
NULL characters through.  In  particular, when you are  done using one  of
the 1200/150 baud ports to  connect to SAIL, you  must either dial up  the
other 1200/150 baud port or use the DIAL program to reach a 300 baud  port
in order  to  put the  first  port back  into  its original  state  (e.g.,
accepting TIP commands) for  the next user.  Hopefully  the TIP people  at
BBN will see the light and give us a cleaner way of handling this soon.

Here are  the steps  to follow  (text to  be typed  in which  is shown  in
brackets is optional):

(1) Dial up a 1200/150 baud TIP port.  (There are currently two:  ports 74
and 77.  We assume in this example that you have dialed up port 77.)

(2) Reset the port to its standard configuration by typing

	@R[eset]<cr>

The TIP should type back its  name, TIP software version number, and  port
number:

	AMES TIP 400 #: 77

(3)  Now type in

	@N[ew] T[elnet]<cr>

to use New Telnet  Protocol rather than the  default Old Telnet  Protocol.
Eight-bit Binary Mode (see below) is only implemented in New Telnet.  Note
that you must get into New Telnet before opening a connection to SAIL.

(4)  Open a connection to SAIL with

	@O[pen] 11<cr>

(5)  Next get into Eight-bit Binary Mode by entering

	@B[inary] I[input] S[tart]<cr>

In this mode  all eight bits  of an  ASCII character are  sent through  to
SAIL.  This  feature allows  the bit  set by  the EDIT  key and  the  NULL
character generated by the NUL key to  get through the TIP to SAIL.   Note
that once this command is given no further TIP commands can be issued from
this port because @ is sent on through also.  See below for how to get out
of Binary Mode.

(6)  Finally tell SAIL that you are a DM with either of

	.TTY DM<cr>
	.TTY Da[tamedia]<cr>

(7) Login and use the system as you normally would with a directly  dialed
DM.

(8) Logout as usual.

(9) Hang up your telephone connection.

(10) Now dial up the OTHER 1200/150  baud AMES-TIP port, in our case  port
74.

(11) Reset port 74 with

	@R[eset]<cr>

(12) Now get port 77 out of Binary Mode with

	@77 B[inary] I[nput] E[nd]<cr>

(13) Now reset port 77 with

	@77 R[eset]<cr>

(14) Finally hang up this telephone connection.

If you use the DIAL program to reach another TIP port, Steps 10-14  should
be inserted just before step 8.  In this case step 10 should read

(10)  Now DIAL a 300 baud AMES-TIP port with the command

	.DIAL <telephone number><cr>
	
followed by "E" when DIAL says it is ready.

Step 14 becomes

(14) Finally hang up this telephone connection and exit DIAL by  inputting
META-Q.
Use of DMs from TENEX hosts

There may be some problems here.  We're working on it...
		[ME, BPM, GFF]
Use of DMs from ITS hosts

People who wish to use DM's on ITS should first declare their
terminal type to ITS via
	:tctyp datamedia

If using a baud rate greater than 1200, the user should also
include a PADCR value of 1 to 4 as necessary for the user's
baud rate.

All of ITS' display facilities are now available to the user.
A user can then use ITS user TELNET's Datamedia simulator to
connect to SAIL.  The most straightforward way of doing this
is to run TELNET as SA or SAIL which will set TELNET up in
magic mode automatically, saving the user a few commands that
otherwise would be necessary (including telling SAIL that you
are a DM!).

There is no way currently to get EDIT sent down to SAIL, as
there are no real DM's locally at Cambridge where this can be
tested at the present time.

A very desireable alternative is to use one of the TV's there.
TELNET checks to see if the terminal has a bucky bit keyboard
and the SAIL graphics set in addition to insert/delete mode
(these are options not all ITS displays may have; i/d mode is
required to use any of the TELNET DM stuff) and if the terminal
fits all of these requirements, TELNET enters a special mode
in which all the TV keys are mapped into their DM bucky bit
protocol equivalents.  ITS ↔ SAIL mappings are done invisibly
such that the Knight keyboard appears to be a funny Stanford
keyboard.  Thus, the user at an ITS TV can be, more or less,
a SAIL TV.